import re

"""
re模块使用步骤
1.使用compile()函数将正则表达式的字符串形式编译为一个Pattern对象
2.通过Pattern对象提供的一系列方法对文本进行匹配查找，获得匹配结果，一个Match对象。
3.最后使用Match对象提供的属性和方法获得信息，根据需要进行其他的操作

"""

"""
Pattern
match 方法：从起始位置开始查找，一次匹配
search 方法：从任何位置开始查找，一次匹配
findall 方法：全部匹配，返回列表
finditer 方法：全部匹配，返回迭代器
split 方法：分割字符串，返回列表
sub 方法：替换
"""

"""
match(string[, pos[, endpos]])
match 方法用于查找字符串的头部（也可以指定起始位置），它是一次匹配，只要找到了一个匹配的结果就返回，而不是查找所有匹配的结果。

参数
string 是待匹配的字符串
pos 和 endpos 是可选参数，指定字符串的起始和终点位置，默认值分别是 0 和 len (字符串长度)

返回值
当匹配成功时，返回一个 Match 对象，如果没有匹配上，则返回 None。
group([group1, ...]) 方法用于获得一个或多个分组匹配的字符串，当要获得整个匹配的子串时，可直接使用 group() 或 group(0)；
start([group]) 方法用于获取分组匹配的子串在整个字符串中的起始位置（子串第一个字符的索引），参数默认值为 0；
end([group]) 方法用于获取分组匹配的子串在整个字符串中的结束位置（子串最后一个字符的索引+1），参数默认值为 0；
span([group]) 方法返回 (start(group), end(group))。


例1
#将正则表达式编译成Pattern对象, 用于匹配至少一个数字
pattern = re.compile(r'\d+')
m = pattern.match('one12twothree34four')
print(m) # None
m = pattern.match('12twothree34four')
print(m) # <re.Match object; span=(0, 2), match='12'>
m = pattern.match('one12twothree34four', 3, 10)
print(m) # None # <re.Match object; span=(4, 5), match='2'>
print(m.group()) # 12
print(m.start()) # 3
print(m.end()) # 5
print(m.span()) # (3, 5)

例2
pattern = re.compile(r'([a-z]+) ([a-z]+)', re.I)  # re.I 表示忽略大小写
m = pattern.match('Hello World Wide Web')
print(m) # <re.Match object; span=(0, 16), match='Hello World Wide'>

"""

"""
search(string[, pos[, endpos]])
用于查找字符串的任何位置，它也是一次匹配，只要找到了一个匹配的结果就返回
当匹配成功时，返回一个 Match 对象，如果没有匹配上，则返回 None。


pattern = re.compile(r'\d+')
m = pattern.search('one12twothree34four')
print(m) # <re.Match object; span=(3, 5), match='12'>
m = pattern.search('one12twothree34four', 5, 10)
print(m) # None

m = pattern.search('hello 123456 789')
if m:
    # 使用 Match 获得分组信息
    print ('matching string:',m.group())
    # 起始位置和结束位置
    print ('position:',m.span())
"""

"""
findall
findall(string[, pos[, endpos]])
以列表形式返回全部能匹配的子串，如果没有匹配，则返回一个空列表

pattern = re.compile(r'\d+')   # 查找数字
result1 = pattern.findall('hello 123456 789')
print (result1) # ['123456', '789']
"""


"""
finditer
finditer 方法的行为跟 findall 的行为类似，也是搜索整个字符串，获得所有匹配的结果。但它返回一个顺序访问每一个匹配结果（Match 对象）的迭代器

pattern = re.compile(r'\d+')
result_iter = pattern.finditer('hello 123456 789')
for m1 in result_iter:   # m1 是 Match 对象
    print ('matching string: {}, position: {}'.format(m1.group(), m1.span()))
"""

"""
split
split(string[, maxsplit])
按照能够匹配的子串将字符串分割后返回列表
maxsplit 用于指定最大分割次数，不指定将全部分割

p = re.compile(r'[\s\,\;]+')
print (p.split('a,b;; c   d'))
"""

"""
sub
sub(repl, string[, count])
用于替换
repl 可以是字符串也可以是一个函数
    其中，repl 可以是字符串也可以是一个函数：
    如果 repl 是字符串，则会使用 repl 去替换字符串每一个匹配的子串，并返回替换后的字符串，另外，repl 还可以使用 id 的形式来引用分组，但不能使用编号 0；
    如果 repl 是函数，这个方法应当只接受一个参数（Match 对象），并返回一个字符串用于替换（返回的字符串中不能再引用分组）。
count 用于指定最多替换次数，不指定时全部替换。

p = re.compile(r'(\w+) (\w+)') # \w = [A-Za-z0-9]
s = 'hello 123, hello 456'
print (p.sub(r'hello world', s))  # 使用 'hello world' 替换 'hello 123' 和 'hello 456', hello world, hello world


"""


"""
匹配中文
在某些情况下，我们想匹配文本中的汉字，有一点需要注意的是，中文的 unicode 编码范围 主要在 [u4e00-u9fa5]，
这里说主要是因为这个范围并不完整，比如没有包括全角（中文）标点，不过，在大部分情况下，应该是够用的。

title = '你好，hello，世界'
pattern = re.compile(r'[\u4e00-\u9fa5]+')
result = pattern.findall(title)

print (result)
"""









